home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / aga / aga136.dms / in.adf / alerttimer / AlertTimer.doc < prev    next >
Encoding:
Text File  |  1993-01-10  |  3.9 KB  |  82 lines
  1.  
  2.  
  3.           A l e r t T i m e r - Software Error Alert Timing Utility
  4.           =========================================================
  5.  
  6.                               (C) 1993 SinSoft
  7.  
  8. Function:
  9. =========
  10. This  little  assembly-written program allows the user to modify and determine
  11. the  time, for which the Software Error and similar exec Alerts are displayed.
  12. This  feature has been introduced in OS3.0 and it is available on all machines
  13. running  this  system.  AlertTimer requires V39 system to work and will return
  14. immediately  with return code 20 if it is attempted to be used on older system
  15. versions.
  16.     This program may be also used when the V39 kickstart is soft-kicked by
  17. the  SKick  program  (from  version  3.30)  on  the  system containing 2.0 ROM
  18. (tested)  or  by the SoftBoot program (not tested).  It will have no effect if
  19. Rekick or ZKick/LKick kickers are used.
  20.     Function  of  AlertTimer  (generally,  alert  timing  function) may be
  21. suppressed  if  various  alert  enhancers  (like  NewAlert by Brian Gontowski,
  22. version  36.3)  are  used.   They  were written for 2.0 system and don't  know
  23. about this new feature.
  24.  
  25. AlertTimer Usage:
  26. =================
  27. AlertTimer  may  be  executed  from  Shell  only.   Its  argument  template is
  28. "TIMING/N,OFF/S".   The  TIMING value represents the time in seconds for which
  29. the  alerts  are  displayed.  Once specified, this value will survive a reboot
  30. and only the full system init (power on) will restore the default value.
  31.     Switch  OFF is used to turn this feature off.  Alerts are then handled
  32. as  if  they  were called by standard DisplayAlert intuition library call.  By
  33. respecifying new TIMING value the timing mechanism is turned on again.
  34.     The  TIMING argument will always override the OFF one in the case both
  35. are used simultaneously.
  36.     Specifying  TIMING=0 will disable alerts at all, i.e.  will cause that
  37. they  are  not  displayed.   This feature may be used if machine is working in
  38. unattended  mode  (BBS  and similar applications) and the fast restart after a
  39. failure is required.
  40.     Calling  AlertTimer  without  arguments will cause a query and current
  41. timing (or OFF status) will be displayed.
  42.     The initial value of alert timing is dependent on the VBlank frequency
  43. and AlertTimer will display 10s on PAL machines and 9s on NTSC ones.  Specifi-
  44. cation  of  new  value respects video frequency and adjusts the internal value
  45. correctly.
  46.     To  test  this feature, simple program called MakeAlert is included in
  47. the  archive.  It will cause a Recoverable Alert to occur.  Alert duration may
  48. be  measured  (using stopwatch, not Amiga) by it.  Of course, any alert may be
  49. terminated by the mouse buttons.
  50.  
  51. Program Description:
  52. ====================
  53. Operation  of  AlertTimer is very simple:  it modifies or displays contents of
  54. variable  in  ExecBase,  responsible  for  the Alert timing.  This variable is
  55. initialized  during  the first exec init (at the power-on time) and maintained
  56. by  exec  automatically  so its contents, once specified, remains unaltered by
  57. reset.  Please read the source code for more details.
  58.     AlertTimer  is  pure  and may be made resident, although I think it is
  59. not  needed,  because  it  will  be  called  once for a long period of machine
  60. operation (possibly from startup-sequence).  It is also position-independent.
  61.  
  62. Copyrights:
  63. ===========
  64. The program, its source code and this documentation are copyright (C) SinSoft,
  65. Prague,  Czech  Republic,  1993.  All the material is public domain and may be
  66. freely  redistributed,  included in software packages, placed on BBS etc.  All
  67. the   files  including  their  copyright  notices  must  be  left  intact  and
  68. unchanged.   No  warranties  of  any  kind  are granted; using this program is
  69. totally at Your own risk.
  70.  
  71.     Any suggestions, bug reports, flames etc. may be sent to:
  72.  
  73.     Pavel Troller        Internet: patrol@aci.cvut.cs
  74.     Jagellonska 16        Bitnet:   patrol@cspuni12
  75.     Praha 3
  76.     130 00
  77.     Czech republic            
  78.  
  79.                         Have fun,
  80.                         Pavel
  81.  
  82.